home *** CD-ROM | disk | FTP | other *** search
/ Logiciels PC Special 3 / Logiciel PC - Hors-Serie 3.iso / Logs / consoles / Lynx / handy060 / Readme.txt < prev    next >
Text File  |  1999-04-17  |  10KB  |  292 lines
  1.          Handy V0.60 - Atari Lynx Emulator for Windows 95/NT
  2.          ---------------------------------------------------
  3.                      Author: Keith Wilkins
  4.                  (handy@dysfuncton.demon.co.uk)
  5.  
  6.        <-------------------HANDY HOMEPAGE-------------------->
  7.                   http://www.dysfunction.demon.co.uk
  8.        <----------------------------------------------------->
  9.  
  10. *********************************************************************
  11.              DO NOT ASK ME FOR LYNX CARTRIDGE IMAGES.
  12.          (I WILL NOT REPLY TO ANY EMAIL ON THIS SUBJECT)
  13. *********************************************************************
  14.  
  15.  
  16. V0.60 Highlights (17/04/99)
  17. ---------------------------
  18. * New save/load game/snapshot facility
  19. * New faster CPU core (5-7%)
  20. * New faster memory access (1-2%)
  21. * A number of UART/Timer IRQ/functionality fixes
  22. * Much lower memory requirements (12MB lower!!!)
  23. * Lynx defaults to AC adaptor plugged in.
  24. * Collision detection improved (Still not perfect)
  25. * Support for headerless development cards (Needs Howard.o)
  26.  
  27.  
  28.  
  29. Index
  30. -----
  31.  
  32. 1.0      Installation
  33.   1.1      Game Images
  34.   1.2      System Requirements
  35. 2.0      Using Handy
  36. 3.0      Emulator Development status
  37. 4.0      Converting cartridges to LNX format with MAKE_LNX.EXE
  38. 5.0      Patching files with ROTATE.EXE
  39. 6.0      With thanks to
  40.  
  41.  
  42. 1.0 Installation
  43. ----------------
  44.  
  45. Unpack all of the files into the directory of your choice. e.g
  46.  
  47. md c:\emu\handy
  48. cd c:\emu\handy
  49. pkunzip handyXXX.zip
  50. del handyXXX.zip
  51.  
  52. If you have lynxboot.img then just unpack it into the same directory.
  53.  
  54. Then just run Handy.exe. If Handy cant find the boot ROM it will put
  55. up a dialog to ask you to locate it. The real lynxboot image is not
  56. provided as part of the Handy distribution as its copyrighted material.
  57.  
  58.  
  59.    1.1 Game images
  60.    ---------------
  61.  
  62. DO NOT ASK ME FOR LYNX CARTRIDGE IMAGES, I WILL NOT REPLY TO ANY EMAIL
  63. ON THIS SUBJECT.
  64.  
  65. NOTE: Handy will NOT run .LYX images, you need to convert to .LNX format
  66. using the supplied 'make_lnx' utility, see section 4.0.
  67.  
  68. You will need a proper lynxboot.img to play carts, this has to be extracted from
  69. the lynx itself to run cartridges, Handy will warn you if you do not have a correct
  70. boot image. I'm sure some unscrupulous person will publish it somewhere along
  71. with game images, just don't ask me for them. The one included in this release
  72. is a fake and is non functional. i.e You cant play cartridges with it.
  73.  
  74. There are a numer of "homebrew" images floating around in homebrew.zip
  75. these are all copyright Bastian Schick and are from his homepage. He
  76. deserves some real high praise for the work he has done.
  77. <-------------------------------------------------->
  78. http://www.gp.fht-esslingen.de/students/mt/elw5basc/
  79. <-------------------------------------------------->
  80.  
  81.  
  82.    1.2 System Requirements
  83.    -----------------------
  84.  
  85. * PC running WindowsNT or Windows95.
  86. * 16MB or more system memory.
  87. * Pentium class processor or better (Recommended P133 or higher).
  88. * Minimum 1MB Hard Disk space + whatever images you require/own.
  89.  
  90. I would not recommend enabling sound if you have anything less than a P133
  91. as its only just acceptable on that class of machine. 
  92.  
  93. This program performs best under 65536(16bit) colour mode, but also works in
  94. 256 colour mode. It will NOT work in 16 colour mode or less.
  95.  
  96.  
  97.  
  98. 2.0 Using Handy
  99. ---------------
  100.  
  101. Just click on the Handy icon and away you go. Select your file from the browser.
  102.  
  103. The keys are mapped to:
  104.  
  105. Option 1     : 1
  106. Option 2     : 2
  107.  
  108. Pause        : Q
  109.  
  110. Inside Fire  : Z
  111. Outside Fire : X
  112.  
  113. Joypad       : Arrow keys
  114.  
  115. Reset Lynx   : F3
  116. Run/Pause    : F5
  117. Sound on/off : Ctrl-S
  118. Load cart    : Ctrl-0
  119. BMP Snapshot : Ctrl-Alt-B
  120. RAW Snapshot : Ctrl-Alt-R
  121. Exit         : Alt-F4
  122.  
  123. Joysticks are supported under W95 by selecting the Joystick label under the
  124. options menu. 
  125.  
  126. Pad - Direction Keys
  127. Button 1 - Lynx Button B (Gravis Gamepad - Red Button)
  128. Button 2 - Lynx Button A (Gravis Gamepad - Blue Button)
  129. Button 3 - Lynx Option 1 (Gravis Gamepad - Yellow Button) 
  130. Button 4 - Lynx Option 2 (Gravis Gamepad - Green Button)
  131.  
  132. Note: Enabling the joystick will slow the emulator slightly, hence the joystick
  133.       defaults to off.
  134.  
  135. You can enter full screen mode at any point by doing Alt-Enter as with a DOS
  136. box, either Esc or Alt-Enter will return you to windowed mode. Any form of
  137. error will cause Handy to revert to windowed mode and then display the error.
  138.  
  139. The type of full screen mode you get will depend on the windowed settings:
  140.  
  141. Windowed        Full Screen
  142. ---------------------------
  143. Normal X1   ==  Normal X1 image in a 320x240 screen
  144. Normal X2   ==  Normal X2 image in a 320x240 screen
  145. Normal X2   ==  Normal X2 image in a 320x240 screen
  146.  
  147. Rotated X1  ==  Rotated X1 images in a 512x384 screen
  148. Rotated X2  ==  Rotated X1 images in a 512x384 screen
  149. Rotated X3  ==  Rotated X1 images in a 512x384 screen
  150.  
  151.  
  152.  
  153. 3.0 Status
  154. ----------
  155.  
  156. Handy is writtin using MSVC 6.0 in C++ using MFC in the windows areas. The
  157. underlying lynx emulation is written entirely in C++ and should be reasonably
  158. easy to port to any other architecture.
  159.  
  160. The documents are not the most fun things to work with, the abiguities within
  161. them mean that often my interpretation of them is incorrect and hence the
  162. large amount of bug fixing to be done, especially in Suzy's sprite engine as
  163. the sprite docs are vague in the extreme in places.
  164.  
  165. Below are the list of know problems:
  166.  
  167. General Problems (affecting some carts)
  168. ----------------
  169. . Flickering sprites
  170. . Flickering backgrounds/colour changes (e.g Shadow of the Beast, Awseome Golf)
  171.   this relates to IRQ timing which is unstable due to some of my optimisations.
  172.  
  173.  
  174. Specific Cartridges
  175. -------------------
  176. SlimeWorld     - Missing sprites i.e the Player ??
  177. Tetris         - Cart calls power down.
  178. BattleZone     - Missing ships, maybe a math related problem.
  179. Warbirds       - Dodgy horizon, maybe a math related problem.
  180. Blue Lightning - Corruption of lanscape when flying at low level.
  181. EuroSoccer     - Runs but some wierd sprite problems
  182. Dirty Larry    - Hangs when player dies, illegal opcode
  183.  
  184. There are minor issues on other cartridges. If you have a cartridge image
  185. that hangs at the blank screen (colour is random) what you'll find is that
  186. you have a corrupted cartridge image. I know for a fact that there are a
  187. whole batch of corrupted images floating around on the net.
  188.  
  189.  
  190. Todo list
  191. ---------
  192. . Implement everon register bit
  193. . Improve integral debugger features
  194. . Improve sound synchronisation.
  195. . Mod c6502 so that +100 is included in SP usage.
  196. . Proper fix for the +1,+1 sprite problem.
  197. . Further optimisation targetting 100% on all games with sound on a P133.
  198.  
  199.  
  200.  
  201. 4.0 Converting cartridges to LNX format with MAKE_LNX.EXE
  202. ---------------------------------------------------------
  203.  
  204. Handy only reads .LNX formats files, any will not read raw (.LYX) cartridge
  205. images. To convert from raw (.LYX/.040) to LNX format use the make_lnx
  206. utility included in with the release.
  207.  
  208. make_lnx <infile> [options]
  209.  
  210. Optional arguments
  211. ------------------
  212.    -o Output filename (Default=<infile>.lnx)
  213.    -m Manufacturer    (Default=Atari)
  214.    -g Game name       (Default=<infile>.lnx)
  215.    -r Left/Right      (Default=no screen image rotation)
  216.    -b0 Bank0 size     (Default=Automatic, options 0K,64K,128K,256K,512K)
  217.    -b1 Bank1 size     (Default=0K, options 0K,64K,128K,256K,512K)
  218.  
  219. The default action (no optional params) is to convert the input filename
  220. from raw format to LNX format with the default options given above. Options
  221. can be mixed and placed in any order on the command line.
  222.  
  223. Example:
  224. make_lnx cgames.lyx                  (Converts cgames.lyx to cgames.lnx)
  225. make_lnx cgames.lyx -o calgames.lnx  (Converts cgames.lyx to calgames.lnx)
  226.  
  227. Part of the LNX header contains game and manufacturer information that may
  228. be used in later versions of Handy, you can add this into the header using
  229. the -g and -m options.
  230.  
  231. Example:
  232.  
  233. make_lnx cgames.lyx -g "California Games" -m Atari
  234.  
  235. (Converts cgames.lyx to cgames.lnx and sets the internal game/manufacturer
  236.  fields within the LNX header. The quotes are important only if your game
  237.  name has spaces within it.)
  238.  
  239.  
  240.  
  241. 5.0 Patching files with ROTATE.EXE
  242. ----------------------------------
  243.  
  244. Handy now supports automatic rotation of images on startup via a flag in the
  245. LNX header of the cartridge. This new addition is completely compatible with
  246. any existing files. One of the spare bytes in the header is now used to
  247. indicate whether which way the screen image should be rotated. A utility has
  248. been provided (ROTATE.EXE) to allow you to patch any existing files you may
  249. have. This facility has also bee added to the MAKE_LNX.EXE utility.
  250.  
  251. Example:
  252.  
  253.    ROTATE LEFT GAUNTLET.LNX
  254.  
  255. This will cause the gaunlet cart header to be modified so that it will be
  256. displayed correctly when starting handy.
  257.  
  258. You can undo the change with
  259.  
  260.   ROTATE DEFAULT GAUNTLET.LNX
  261.  
  262. Gauntlet will then revert back to the landscape style display.
  263.  
  264.  
  265.  
  266. 6.0 With Thanks
  267. ---------------
  268.  
  269. Lee Witek         - All round mate and windows guru.
  270.  
  271. Bastian Schick    - Your HTML lynx docs make my paper copy redundant, thanks.
  272.                     Also a big thanks for all of your lynx development work.
  273.  
  274. Harry Dodgson     - Insights into timer related pernicousness...
  275.                     Help with test code for sprite engine bugs.
  276.                   
  277. RTOONist          - Beta testing & suggestions.
  278.  
  279. Riddler           - Beta testing.
  280.  
  281. Jonas Gustavsson  - DEC Alpha Port
  282.  
  283. Ruchard Bannister - Apple MAC Port
  284.  
  285. ??? ????          - Linux Port
  286.  
  287.  
  288.  
  289. Thanks to all those who've emailed their support.
  290.  
  291. --- END OF FILE ---
  292.